Pythonning 'email' paketini mukammal egallash: MIME xabarlarini yaratish san'ati va ishonchli tahlil qilish

Elektron pochta shaxsiy yozishmalar, biznes operatsiyalari va avtomatlashtirilgan tizim bildirishnomalari uchun ajralmas bo'lgan global aloqaning asosiy toshi bo'lib qolmoqda. Har bir formatlangan matnli elektron xat, har bir ilova va har bir ehtiyotkorlik bilan formatlangan imzo ortida Ko'p maqsadli Internet pochta kengaytmalari (MIME) murakkabligi yotadi. Dasturchilar, ayniqsa Python bilan ishlaydiganlar uchun, ushbu MIME xabarlarini dasturiy ravishda yaratish va tahlil qilishni o'rganish muhim mahoratdir.

Pythonning o'rnatilgan email paketi elektron pochta xabarlari bilan ishlash uchun mustahkam va keng qamrovli freymvorkni taqdim etadi. Bu faqat oddiy matn yuborish uchun emas; u MIMEning murakkab tafsilotlarini soddalashtirish uchun mo'ljallangan bo'lib, sizga murakkab elektron xatlar yaratish va kiruvchi xatlardan ma'lum ma'lumotlarni ajoyib aniqlik bilan ajratib olish imkonini beradi. Ushbu qo'llanma sizni ushbu paketning ikki asosiy jihati: yuborish uchun MIME xabarlarini yaratish va ma'lumotlarni ajratib olish uchun ularni tahlil qilish bo'yicha chuqur o'rganishga olib boradi va eng yaxshi amaliyotlar bo'yicha global nuqtai nazarni taqdim etadi.

Yaratish va tahlil qilishni tushunish juda muhimdir. Xabar yaratganingizda, siz aslida uning tuzilishini va tarkibini boshqa tizim talqin qilishi uchun belgilaysiz. Tahlil qilganingizda esa, siz boshqa tizim tomonidan belgilangan tuzilma va tarkibni talqin qilasiz. Birini chuqur tushunish, ikkinchisini o'zlashtirishga katta yordam beradi, bu esa yanada mustahkam va o'zaro muvofiq ishlaydigan elektron pochta ilovalariga olib keladi.

MIME tushunchasi: Zamonaviy elektron pochtaning asosi

Pythonning o'ziga xos xususiyatlariga sho'ng'ishdan oldin, MIME nima ekanligini va nima uchun u juda muhim ekanligini tushunish kerak. Dastlab, elektron pochta xabarlari faqat oddiy matn (7-bitli ASCII belgilari) bilan cheklangan edi. 1990-yillarning boshlarida joriy etilgan MIME elektron pochtaning imkoniyatlarini quyidagilarni qo'llab-quvvatlash uchun kengaytirdi:

• ASCII bo'lmagan belgilar: Arab, xitoy, rus yoki ASCII to'plamidan tashqaridagi belgilardan foydalanadigan har qanday boshqa tildagi matnlarga ruxsat berish.
• Ilovalar: Hujjatlar, rasmlar, audio va video kabi fayllarni yuborish.
• Formatlangan matn: Qalin, kursiv, ranglar va maketlar bilan HTML elektron xatlar.
• Ko'p qismlar: Oddiy matn, HTML va ilovalarni bitta elektron xatda birlashtirish.

MIME bunga elektron pochta xabariga maxsus sarlavhalar qo'shish va uning asosiy qismini turli "qismlar"ga ajratish orqali erishadi. Siz duch keladigan asosiy MIME sarlavhalari quyidagilardan iborat:

• Content-Type: Bir qismdagi ma'lumotlar turini belgilaydi (masalan, text/plain, text/html, image/jpeg, application/pdf, multipart/alternative). U ko'pincha charset parametrini ham o'z ichiga oladi (masalan, charset=utf-8).
• Content-Transfer-Encoding: Elektron pochta klienti tarkibni qanday dekodlashi kerakligini ko'rsatadi (masalan, binar ma'lumotlar uchun base64, ba'zi ASCII bo'lmagan belgilarga ega asosan matn uchun quoted-printable).
• Content-Disposition: Qabul qiluvchining elektron pochta klienti qismni qanday ko'rsatishi kerakligini taklif qiladi (masalan, xabar matnida ko'rsatish uchun inline, saqlanadigan fayl uchun attachment).

Python email paketi: Chuqur o'rganish

Pythonning email paketi elektron pochta xabarlarini dasturiy ravishda yaratish, tahlil qilish va o'zgartirish uchun mo'ljallangan keng qamrovli kutubxonadir. U elektron pochtaning tuzilishini ifodalovchi Message obyektlari kontseptsiyasi atrofida qurilgan.

Paket tarkibidagi asosiy modullar:

• email.message: Elektron pochta xabarlarini yaratish va boshqarish uchun asosiy interfeys bo'lgan EmailMessage klassini o'z ichiga oladi. Bu MIME tafsilotlarini avtomatik ravishda boshqaradigan juda moslashuvchan klassdir.
• email.mime: MIME tuzilishi ustidan aniqroq nazoratni ta'minlovchi eski klasslarni (MIMEText, MIMEMultipart kabi) taqdim etadi. Odatda yangi kod uchun EmailMessage soddaligi tufayli afzal ko'rilsa-da, ushbu klasslarni tushunish foydali bo'lishi mumkin.
• email.parser: Xom elektron pochta ma'lumotlarini (baytlar yoki satrlar) EmailMessage obyektlariga aylantirish uchun BytesParser va Parser kabi klasslarni taklif etadi.
• email.policy: Sarlavha kodlanishi, qator oxirlari va xatolarni qayta ishlashga ta'sir ko'rsatuvchi, elektron pochta xabarlarining qanday yaratilishi va tahlil qilinishini boshqaradigan siyosatlarni belgilaydi.

Ko'pgina zamonaviy holatlar uchun siz asosan ham yaratish, ham tahlil qilingan xabar obyekti uchun email.message.EmailMessage klassi bilan ishlaysiz. Uning usullari eski email.mime klasslari bilan ancha murakkab bo'lgan jarayonni sezilarli darajada soddalashtiradi.

MIME xabarlarini yaratish: Elektron xatlarni aniqlik bilan tuzish

Elektron xatlarni yaratish turli komponentlarni (matn, HTML, ilovalar) yaroqli MIME tuzilmasiga yig'ishni o'z ichiga oladi. EmailMessage klassi bu jarayonni sezilarli darajada soddalashtiradi.

Oddiy matnli xatlar

Eng oddiy elektron xat oddiy matndir. Siz uni yaratishingiz va asosiy sarlavhalarni osongina o'rnatishingiz mumkin:

from email.message import EmailMessage

msg = EmailMessage()
msg['Subject'] = 'Greetings from Python'
msg['From'] = 'sender@example.com'
msg['To'] = 'recipient@example.com'
msg.set_content('Hello, this is a plain text email sent from Python.\n\nBest regards,\nYour Python Script')

print(msg.as_string())

Tushuntirish:

• EmailMessage() bo'sh xabar obyektini yaratadi.
• Lug'atga o'xshash kirish (msg['Subject'] = ...) umumiy sarlavhalarni o'rnatadi.
• set_content() elektron pochtaning asosiy tarkibini qo'shadi. Sukut bo'yicha u Content-Type: text/plain; charset="utf-8" ni aniqlaydi.
• as_string() xabarni SMTP orqali yuborish yoki faylga saqlash uchun mos keladigan satr formatiga seriyalashtiradi.

HTML tarkibini qo'shish

HTML elektron xat yuborish uchun siz shunchaki set_content() ni chaqirayotganda kontent turini belgilaysiz. HTMLni ko'rsatmaydigan elektron pochta klientlariga ega qabul qiluvchilar uchun yoki qulaylik nuqtai nazaridan oddiy matnli alternativani taqdim etish yaxshi amaliyotdir.

from email.message import EmailMessage

msg = EmailMessage()
msg['Subject'] = 'Your HTML Newsletter'
msg['From'] = 'newsletter@example.com'
msg['To'] = 'subscriber@example.com'

html_content = """
<html>
    <head></head>
    <body>
        <h1>Welcome to Our Global Update!</h1>
        <p>Dear Subscriber,</p>
        <p>This is your <strong>latest update</strong> from around the world.</p>
        <p>Visit our <a href="http://www.example.com">website</a> for more.</p>
        <p>Best regards,<br>The Team</p>
    </body>
</html>
"""

# Add the HTML version
msg.add_alternative(html_content, subtype='html')

# Add a plain text fallback
plain_text_content = (
    "Welcome to Our Global Update!\n\n"
    "Dear Subscriber,\n\n"
    "This is your latest update from around the world.\n"
    "Visit our website for more: http://www.example.com\n\n"
    "Best regards,\nThe Team"
)
msg.add_alternative(plain_text_content, subtype='plain')

print(msg.as_string())

Tushuntirish:

• add_alternative() *bir xil* tarkibning turli ko'rinishlarini qo'shish uchun ishlatiladi. Elektron pochta klienti o'zi ishlay oladigan "eng yaxshi"sini ko'rsatadi (odatda HTML).
• Bu avtomatik ravishda multipart/alternative MIME tuzilmasini yaratadi.

Ilovalar bilan ishlash

Fayllarni biriktirish add_attachment() yordamida juda oson. Siz har qanday turdagi faylni biriktirishingiz mumkin va paket tegishli MIME turlari va kodlashlarni (odatda base64) boshqaradi.

from email.message import EmailMessage
from pathlib import Path

# Create dummy files for demonstration
Path('report.pdf').write_bytes(b'%PDF-1.4\n1 0 obj<</Type/Catalog/Pages 2 0 R>>endobj\n2 0 obj<</Count 0>>endobj\nxref\n0 3\n0000000000 65535 f\n0000000009 00000 n\n0000000052 00000 n\ntrailer<</Size 3/Root 1 0 R>>startxref\n104\n%%EOF') # A very basic, invalid PDF placeholder
Path('logo.png').write_bytes(b'\x89PNG\r\n\x1a\n\x00\x00\x00\rIHDR\x00\x00\x00\x01\x00\x00\x00\x01\x08\x06\x00\x00\x00\x1f\x15\xc4\x89\x00\x00\x00\x0cIDAT\x08\x99c`\x00\x00\x00\x02\x00\x01\xe2!\x00\xa0\x00\x00\x00\x00IEND\xaeB`\x82') # A 1x1 transparent PNG placeholder

msg = EmailMessage()
msg['Subject'] = 'Important Document and Image'
msg['From'] = 'sender@example.com'
msg['To'] = 'recipient@example.com'
msg.set_content('Please find the attached report and company logo.')

# Attach a PDF file
with open('report.pdf', 'rb') as f:
    file_data = f.read()
    msg.add_attachment(
        file_data,
        maintype='application',
        subtype='pdf',
        filename='Annual_Report_2024.pdf'
    )

# Attach an image file
with open('logo.png', 'rb') as f:
    image_data = f.read()
    msg.add_attachment(
        image_data,
        maintype='image',
        subtype='png',
        filename='CompanyLogo.png'
    )

print(msg.as_string())

# Clean up dummy files
Path('report.pdf').unlink()
Path('logo.png').unlink()

Tushuntirish:

• add_attachment() fayl tarkibining xom baytlarini oladi.
• maintype va subtype MIME turini belgilaydi (masalan, application/pdf, image/png). Bular qabul qiluvchining elektron pochta klienti ilovani to'g'ri aniqlashi va qayta ishlashi uchun juda muhimdir.
• filename ilova qabul qiluvchi tomonidan saqlanadigan nomni taqdim etadi.
• Bu avtomatik ravishda multipart/mixed tuzilmasini o'rnatadi.

Ko'p qismli xabarlarni yaratish

Sizda HTML tanasi, oddiy matnli alternativasi va ichki rasmlar yoki bog'liq fayllarga ega xabar bo'lsa, sizga murakkabroq ko'p qismli tuzilma kerak bo'ladi. EmailMessage klassi buni add_related() va add_alternative() yordamida aqlli ravishda boshqaradi.

Keng tarqalgan stsenariy bu - HTML ichiga to'g'ridan-to'g'ri joylashtirilgan rasmga ega HTML elektron xati ("inline" rasm). Bu multipart/related dan foydalanadi.

from email.message import EmailMessage
from pathlib import Path

# Create a dummy image file for demonstration (a 1x1 transparent PNG)
Path('banner.png').write_bytes(b'\x89PNG\r\n\x1a\n\x00\x00\x00\rIHDR\x00\x00\x00\x01\x00\x00\x00\x01\x08\x06\x00\x00\x00\x1f\x15\xc4\x89\x00\x00\x00\x0cIDAT\x08\x99c`\x00\x00\x00\x02\x00\x01\xe2!\x00\xa0\x00\x00\x00\x00IEND\xaeB`\x82')

msg = EmailMessage()
msg['Subject'] = 'Inline Image Example'
msg['From'] = 'sender@example.com'
msg['To'] = 'recipient@example.com'

# Plain text version (fallback)
plain_text = 'Check out our amazing banner!\n\n[Image: Banner.png]\n\nVisit our site.'
msg.set_content(plain_text, subtype='plain') # Set initial plain text content

# HTML version (with CID for inline image)
html_content = """
<html>
    <head></head>
    <body>
        <h1>Our Latest Offer!</h1>
        <p>Dear Customer,</p>
        <p>Don't miss out on our special global promotion:</p>
        <img src="cid:my-banner-image" alt="Promotion Banner">
        <p>Click <a href="http://www.example.com">here</a> to learn more.</p>
    </body>
</html>
"""

msg.add_alternative(html_content, subtype='html') # Add HTML alternative

# Add the inline image (related content)
with open('banner.png', 'rb') as img_file:
    image_data = img_file.read()
    msg.add_related(
        image_data,
        maintype='image',
        subtype='png',
        cid='my-banner-image' # This CID matches the 'src' in HTML
    )

print(msg.as_string())

# Clean up dummy file
Path('banner.png').unlink()

Tushuntirish:

• set_content() dastlabki tarkibni o'rnatadi (bu yerda, oddiy matn).
• add_alternative() HTML versiyasini qo'shib, oddiy matn va HTML qismlarini o'z ichiga olgan multipart/alternative tuzilmasini yaratadi.
• add_related() xabar qismlaridan biriga "bog'liq" bo'lgan tarkib uchun ishlatiladi, odatda HTMLdagi ichki rasmlar. U cid (Content-ID) parametrini oladi, keyin esa HTML <img src="cid:my-banner-image"> tegida unga havola qilinadi.
• Yakuniy tuzilma multipart/mixed (agar tashqi ilovalar bo'lsa) bo'ladi, u multipart/alternative qismini o'z ichiga oladi, bu esa o'z navbatida multipart/related qismini o'z ichiga oladi. multipart/related qismi HTML va ichki rasmni o'z ichiga oladi. EmailMessage klassi bu ichki joylashuv murakkabligini siz uchun boshqaradi.

Global qamrov uchun kodlash va belgilar to'plami

Xalqaro aloqa uchun to'g'ri belgilarni kodlash juda muhimdir. email paketi, sukut bo'yicha, butun dunyodagi turli belgilar to'plamlari bilan ishlash uchun universal standart bo'lgan UTF-8 dan foydalanishga qat'iy yo'naltirilgan.

from email.message import EmailMessage

msg = EmailMessage()
msg['Subject'] = 'Global Characters: こんにちは, Привет, नमस्ते'
msg['From'] = 'global_sender@example.com'
msg['To'] = 'global_recipient@example.com'

# Japanese, Russian, and Hindi characters
content = "This message contains diverse global characters:\n"
content += "こんにちは (Japanese)\n"
content += "Привет (Russian)\n"
content += "नमस्ते (Hindi)\n\n"
content += "The 'email' package handles UTF-8 gracefully."

msg.set_content(content)

print(msg.as_string())

Tushuntirish:

• set_content() Python satrini olganda, u avtomatik ravishda uni UTF-8 ga kodlaydi va Content-Type: text/plain; charset="utf-8" sarlavhasini o'rnatadi.
• Agar tarkib buni talab qilsa (masalan, ko'plab ASCII bo'lmagan belgilarni o'z ichiga olsa), u eski elektron pochta tizimlari orqali xavfsiz uzatishni ta'minlash uchun Content-Transfer-Encoding: quoted-printable yoki base64 ni ham qo'llashi mumkin. Paket buni tanlangan siyosatga muvofiq avtomatik ravishda boshqaradi.

Maxsus sarlavhalar va siyosatlar

Siz elektron pochtaga har qanday maxsus sarlavha qo'shishingiz mumkin. Siyosatlar (email.policy dan) xabarlarning qanday qayta ishlanishini belgilaydi, sarlavha kodlanishi, qator oxirlari va xatolarni qayta ishlash kabi jihatlarga ta'sir qiladi. Sukut bo'yicha siyosat odatda yaxshi, ammo siz qat'iy SMTP muvofiqligi uchun `SMTP` ni tanlashingiz yoki maxsus siyosatlar belgilashingiz mumkin.

from email.message import EmailMessage
from email import policy

msg = EmailMessage(policy=policy.SMTP)
msg['Subject'] = 'Email with Custom Header'
msg['From'] = 'info@example.org'
msg['To'] = 'user@example.org'
msg['X-Custom-Header'] = 'This is a custom value for tracking'
msg['Reply-To'] = 'support@example.org'
msg.set_content('This email demonstrates custom headers and policies.')

print(msg.as_string())

Tushuntirish:

• policy=policy.SMTP dan foydalanish SMTP standartlariga qat'iy muvofiqlikni ta'minlaydi, bu yetkazib berish uchun muhim bo'lishi mumkin.
• Maxsus sarlavhalar standart sarlavhalar kabi qo'shiladi. Ular ko'pincha nostandart sarlavhalarni bildirish uchun X- bilan boshlanadi.

MIME xabarlarini tahlil qilish: Kelayotgan xatlardan ma'lumotlarni ajratib olish

Tahlil qilish xom elektron pochta ma'lumotlarini (odatda IMAP orqali yoki fayldan olingan) olish va uni `EmailMessage` obyektiga aylantirishni o'z ichiga oladi, so'ngra siz uni osongina tekshirishingiz va boshqarishingiz mumkin.

Yuklash va dastlabki tahlil qilish

Siz odatda elektron xatlarni xom baytlar sifatida olasiz. Buning uchun email.parser.BytesParser (yoki qulaylik funksiyalari email.message_from_bytes()) ishlatiladi.

from email.parser import BytesParser
from email.policy import default

raw_email_bytes = b"""
From: sender@example.com
To: recipient@example.com
Subject: Test Email with Basic Headers
Date: Mon, 1 Jan 2024 10:00:00 +0000
Content-Type: text/plain; charset="utf-8"

This is the body of the email.
It's a simple test.
"""

# Using BytesParser
parser = BytesParser(policy=default)
msg = parser.parsebytes(raw_email_bytes)

# Or using the convenience function
# from email import message_from_bytes
# msg = message_from_bytes(raw_email_bytes, policy=default)

print(f"Subject: {msg['subject']}")
print(f"From: {msg['from']}")
print(f"Content-Type: {msg['Content-Type']}")

Tushuntirish:

• BytesParser xom bayt ma'lumotlarini (elektron pochta shu tarzda uzatiladi) oladi va EmailMessage obyektini qaytaradi.
• policy=default tahlil qilish qoidalarini belgilaydi.

Sarlavhalarga kirish

Sarlavhalarga lug'atga o'xshash kalitlar orqali osongina kirish mumkin. Paket kodlangan sarlavhalarni (masalan, xalqaro belgilarga ega mavzular) avtomatik ravishda dekodlashni boshqaradi.

# ... (using the 'msg' object from the previous parsing example)

print(f"Date: {msg['date']}")
print(f"Message ID: {msg['Message-ID'] if 'Message-ID' in msg else 'N/A'}")

# Handling multiple headers (e.g., 'Received' headers)
# from email.message import EmailMessage # If not imported yet
# from email import message_from_string # For a quick string example

multi_header_email = message_from_string(
    """
From: a@example.com
To: b@example.com
Subject: Multi-header Test
Received: from client.example.com (client.example.com [192.168.1.100])
        by server.example.com (Postfix) with ESMTP id 123456789
        for <b@example.com>; Mon, 1 Jan 2024 10:00:00 +0000 (GMT)
Received: from mx.another.com (mx.another.com [192.168.1.101])
        by server.example.com (Postfix) with ESMTP id 987654321
        for <b@example.com>; Mon, 1 Jan 2024 09:59:00 +0000 (GMT)

Body content here.
"""
)

received_headers = multi_header_email.get_all('received')
if received_headers:
    print("\nReceived Headers:")
    for header in received_headers:
        print(f"- {header}")

Tushuntirish:

• Sarlavhaga kirish uning qiymatini satr sifatida qaytaradi.
• get_all('header-name') bir necha marta paydo bo'lishi mumkin bo'lgan sarlavhalar uchun foydalidir (masalan, Received).
• Paket sarlavhalarni dekodlashni boshqaradi, shuning uchun Subject: =?utf-8?Q?Global_Characters:_=E3=81=93=E3=82=93=E3=81=AB=E3=81=A1=E3=81=AF?= kabi qiymatlar avtomatik ravishda o'qiladigan satrlarga aylantiriladi.

Xabar matnini ajratib olish

Haqiqiy xabar matnini ajratib olish xabarning ko'p qismli ekanligini tekshirishni talab qiladi. Ko'p qismli xabarlar uchun uning qismlari bo'yicha iteratsiya qilasiz.

from email.message import EmailMessage
from email import message_from_string

multipart_email_raw = """
From: multi@example.com
To: user@example.com
Subject: Test Multipart Email
Content-Type: multipart/alternative; boundary="_----------=_12345"

--_----------=_12345
Content-Type: text/plain; charset="utf-8"

Hello from the plain text part!

--_----------=_12345
Content-Type: text/html; charset="utf-8"

<html>
<body>
<h1>Hello from the HTML part!</h1>
<p>This is a <strong>rich text</strong> email.</p>
</body>
</html>

--_----------=_12345--
"""

msg = message_from_string(multipart_email_raw)

if msg.is_multipart():
    print("\n--- Multipart Email Body ---")
    for part in msg.iter_parts():
        content_type = part.get_content_type()
        charset = part.get_content_charset() or 'utf-8' # Default to utf-8 if not specified
        payload = part.get_payload(decode=True) # Decode payload bytes

        try:
            decoded_content = payload.decode(charset)
            print(f"Content-Type: {content_type}, Charset: {charset}\nContent:\n{decoded_content}\n")
        except UnicodeDecodeError:
            print(f"Content-Type: {content_type}, Charset: {charset}\nContent: (Binary or undecodable data)\n")
            # Handle binary data, or attempt a fallback encoding
else:
    print("\n--- Single Part Email Body ---")
    charset = msg.get_content_charset() or 'utf-8'
    payload = msg.get_payload(decode=True)
    try:
        decoded_content = payload.decode(charset)
        print(f"Content-Type: {msg.get_content_type()}, Charset: {charset}\nContent:\n{decoded_content}\n")
    except UnicodeDecodeError:
        print(f"Content: (Binary or undecodable data)\n")

Tushuntirish:

• is_multipart() elektron pochtaning bir nechta qismdan iborat ekanligini aniqlaydi.
• iter_parts() ko'p qismli xabarning barcha quyi qismlari bo'yicha iteratsiya qiladi.
• get_content_type() to'liq MIME turini qaytaradi (masalan, text/plain).
• get_content_charset() Content-Type sarlavhasidan charsetni ajratib oladi.
• get_payload(decode=True) juda muhim: u *dekodlangan* tarkibni baytlar sifatida qaytaradi. Keyin siz Python satrini olish uchun bu baytlarni to'g'ri charset yordamida .decode() qilishingiz kerak.

Tahlil paytida ilovalarni qayta ishlash

Ilovalar ham ko'p qismli xabarning bir qismidir. Siz ularni Content-Disposition sarlavhasi yordamida aniqlashingiz va dekodlangan yuklamasini saqlashingiz mumkin.

from email.message import EmailMessage
from email import message_from_string
import os

# Example email with a simple attachment
email_with_attachment = """
From: attach@example.com
To: user@example.com
Subject: Document Attached
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="_----------=_XYZ"

--_----------=_XYZ
Content-Type: text/plain; charset="utf-8"

Here is your requested document.

--_----------=_XYZ
Content-Type: application/pdf
Content-Transfer-Encoding: base64
Content-Disposition: attachment; filename="document.pdf"

JVBERi0xLjQKMSAwIG9iagpbL1BERi9UZXh0L0ltYWdlQy9JbWFnZUkvSW1hZ0VCXQplbmRvYmoK

--_----------=_XYZ--
"""

msg = message_from_string(email_with_attachment)

output_dir = 'parsed_attachments'
os.makedirs(output_dir, exist_ok=True)

print("\n--- Processing Attachments ---")
for part in msg.iter_attachments():
    filename = part.get_filename()
    if filename:
        filepath = os.path.join(output_dir, filename)
        try:
            with open(filepath, 'wb') as f:
                f.write(part.get_payload(decode=True))
            print(f"Saved attachment: {filepath} (Type: {part.get_content_type()})")
        except Exception as e:
            print(f"Error saving {filename}: {e}")
    else:
        print(f"Found an attachment without a filename (Content-Type: {part.get_content_type()})")

# Clean up the output directory
# import shutil
# shutil.rmtree(output_dir)

Tushuntirish:

• iter_attachments() ilova bo'lishi ehtimoli yuqori bo'lgan qismlarni (ya'ni, Content-Disposition: attachment sarlavhasiga ega yoki boshqa tarzda tasniflanmagan) maxsus beradi.
• get_filename() Content-Disposition sarlavhasidan fayl nomini ajratib oladi.
• part.get_payload(decode=True) ilovaning xom binar tarkibini, base64 yoki quoted-printable dan allaqachon dekodlangan holda oladi.

Kodlashlar va belgilar to'plamini dekodlash

email paketi get_payload(decode=True) ni chaqirganingizda umumiy uzatish kodlashlarini (base64, quoted-printable kabi) avtomatik dekodlashda ajoyib ish qiladi. Matn tarkibi uchun esa, u Content-Type sarlavhasida ko'rsatilgan charset dan foydalanishga harakat qiladi. Agar charset ko'rsatilmagan yoki yaroqsiz bo'lsa, siz buni ehtiyotkorlik bilan hal qilishingiz kerak bo'lishi mumkin.

from email.message import EmailMessage
from email import message_from_string

# Example with a potentially problematic charset
email_latin1 = """
From: legacy@example.com
To: new_system@example.com
Subject: Special characters: àéíóú
Content-Type: text/plain; charset="iso-8859-1"

This message contains Latin-1 characters: àéíóú
"""

msg = message_from_string(email_latin1)

if msg.is_multipart():
    for part in msg.iter_parts():
        payload = part.get_payload(decode=True)
        charset = part.get_content_charset() or 'utf-8'
        try:
            print(f"Decoded (Charset: {charset}): {payload.decode(charset)}")
        except UnicodeDecodeError:
            print(f"Failed to decode with {charset}. Trying fallback...")
            # Fallback to a common charset or 'latin-1' if expecting it
            print(f"Decoded (Fallback Latin-1): {payload.decode('latin-1', errors='replace')}")
else:
    payload = msg.get_payload(decode=True)
    charset = msg.get_content_charset() or 'utf-8'
    try:
        print(f"Decoded (Charset: {charset}): {payload.decode(charset)}")
    except UnicodeDecodeError:
        print(f"Failed to decode with {charset}. Trying fallback...")
        print(f"Decoded (Fallback Latin-1): {payload.decode('latin-1', errors='replace')}")

Tushuntirish:

• Har doim Content-Type sarlavhasida ko'rsatilgan charsetdan foydalanishga harakat qiling.
• Ayniqsa, turli xil va potentsial nostandart manbalardan kelgan elektron xatlar bilan ishlaganda, mustahkamlik uchun try-except UnicodeDecodeError blokidan foydalaning.
• errors='replace' yoki errors='ignore' ni .decode() bilan ishlatish, maqsadli kodlashga mos kelmaydigan belgilarni qayta ishlashga va ishdan chiqishning oldini olishga yordam beradi.

Murakkab tahlil qilish stsenariylari

Haqiqiy dunyodagi elektron xatlar ichma-ich joylashgan ko'p qismli tuzilmalarga ega bo'lib, juda murakkab bo'lishi mumkin. email paketining rekursiv tabiati bularni navigatsiya qilishni osonlashtiradi. Siz is_multipart() ni iter_parts() bilan birlashtirib, chuqur joylashgan xabarlarni kezib chiqishingiz mumkin.

from email.message import EmailMessage
from email import message_from_string

def parse_email_part(part, indent=0):
    prefix = "  " * indent
    content_type = part.get_content_type()
    charset = part.get_content_charset() or 'N/A'
    print(f"{prefix}Part Type: {content_type}, Charset: {charset}")

    if part.is_multipart():
        for subpart in part.iter_parts():
            parse_email_part(subpart, indent + 1)
    elif part.get_filename(): # It's an attachment
        print(f"{prefix}  Attachment: {part.get_filename()} (Size: {len(part.get_payload(decode=True))} bytes)")
    else: # It's a regular text/html body part
        payload = part.get_payload(decode=True)
        try:
            decoded_content = payload.decode(charset)
            # print(f"{prefix}  Content (first 100 chars): {decoded_content[:100]}...") # For brevity
        except UnicodeDecodeError:
            print(f"{prefix}  Content: (Binary or undecodable text)")

complex_email_raw = """
From: complex@example.com
To: receiver@example.com
Subject: Complex Email with HTML, Plain, and Attachment
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="outer_boundary"

--outer_boundary
Content-Type: multipart/alternative; boundary="inner_boundary"

--inner_boundary
Content-Type: text/plain; charset="utf-8"

Plain text content.

--inner_boundary
Content-Type: text/html; charset="utf-8"

<html><body><h2>HTML Content</h2></body></html>

--inner_boundary--

--outer_boundary
Content-Type: application/octet-stream
Content-Transfer-Encoding: base64
Content-Disposition: attachment; filename="data.bin"

SGVsbG8gV29ybGQh

--outer_boundary--
"""

msg = message_from_string(complex_email_raw)
print("\n--- Traversing Complex Email Structure ---")
parse_email_part(msg)

Tushuntirish:

• Rekursiv parse_email_part funksiyasi butun xabar daraxti bo'ylab yurib, har bir darajada ko'p qismli qismlarni, ilovalarni va asosiy tarkibni aniqlashni ko'rsatadi.
• Ushbu namuna chuqur joylashgan elektron xatlardan ma'lum turdagi tarkibni ajratib olish uchun juda moslashuvchan.

Yaratish va Tahlil qilish: Qiyosiy tahlil

Garchi alohida operatsiyalar bo'lsa-da, yaratish va tahlil qilish bir tanganning ikki tomoni: MIME xabarlarini qayta ishlash. Birini tushunish, muqarrar ravishda ikkinchisiga yordam beradi.

Yaratish (Yuborish):

• Fokus: Sarlavhalar, tarkib va ilovalarni standartlarga mos MIME tuzilmasiga to'g'ri yig'ish.
• Asosiy vosita: email.message.EmailMessage va uning set_content(), add_attachment(), add_alternative(), add_related() kabi usullari.
• Asosiy qiyinchiliklar: To'g'ri MIME turlarini, belgi to'plamlarini (ayniqsa, global qo'llab-quvvatlash uchun UTF-8), `Content-Transfer-Encoding` va to'g'ri sarlavha formatlashni ta'minlash. Xatolar elektron xatlarning noto'g'ri ko'rsatilishiga, ilovalarning buzilishiga yoki xabarlarning spam sifatida belgilanishiga olib kelishi mumkin.

Tahlil qilish (Qabul qilish):

• Fokus: Xom elektron pochta bayt oqimini uning tarkibiy qismlariga ajratish, maxsus sarlavhalarni, asosiy tarkibni va ilovalarni ajratib olish.
• Asosiy vosita: email.parser.BytesParser yoki email.message_from_bytes(), so'ngra hosil bo'lgan EmailMessage obyekti bilan is_multipart(), iter_parts(), get_payload(), get_filename() kabi usullar va sarlavhalarga kirish orqali ishlash.
• Asosiy qiyinchiliklar: Noto'g'ri formatlangan elektron xatlar bilan ishlash, belgi kodlashlarini to'g'ri aniqlash (ayniqsa, noaniq bo'lganda), yo'q sarlavhalar bilan ishlash va turli MIME tuzilmalaridan ma'lumotlarni mustahkam ajratib olish.

`EmailMessage` yordamida yaratgan xabaringiz `BytesParser` tomonidan mukammal tahlil qilinishi kerak. Xuddi shunday, tahlil paytida hosil bo'lgan MIME tuzilishini tushunish, sizga murakkab xabarlarni qanday qurish haqida tushuncha beradi.

Python yordamida global elektron pochtani qayta ishlash bo'yicha eng yaxshi amaliyotlar

Global auditoriya bilan ishlaydigan yoki turli xil elektron pochta manbalarini qayta ishlaydigan ilovalar uchun ushbu eng yaxshi amaliyotlarni ko'rib chiqing:

• UTF-8 ga standartlashtirish: Har doim barcha matnli tarkib uchun UTF-8 dan foydalaning, ham yaratishda, ham tahlil qilishda. Bu belgilarni kodlash uchun global standart bo'lib, mojibake (buzilgan matn) ning oldini oladi.
• Elektron pochta manzillarini tekshirish: Yuborishdan oldin, yetkazib berishni ta'minlash uchun qabul qiluvchining elektron pochta manzillarini tekshiring. Tahlil paytida `From`, `To` yoki `Cc` sarlavhalarida potentsial yaroqsiz yoki noto'g'ri formatlangan manzillarga tayyor bo'ling.
• Qattiq sinovdan o'tkazish: HTML va ilovalarning barqaror ko'rsatilishini ta'minlash uchun elektron pochta yaratishingizni turli xil elektron pochta klientlari (Gmail, Outlook, Apple Mail, Thunderbird) va platformalarda sinab ko'ring. Tahlil qilish uchun, noodatiy kodlashlar, yo'q sarlavhalar yoki murakkab ichki tuzilmalarga ega bo'lgan keng ko'lamli namuna elektron xatlar bilan sinovdan o'tkazing.
• Tahlil qilingan ma'lumotlarni tozalash: Kiruvchi elektron xatlardan olingan tarkibni har doim ishonchsiz deb hisoblang. Agar siz uni veb-ilovada ko'rsatsangiz, XSS hujumlarining oldini olish uchun HTML tarkibini tozalang. Fayllarni saqlashda yo'l bo'ylab o'tish (path traversal) yoki boshqa xavfsizlik zaifliklarining oldini olish uchun ilova fayl nomlari va turlarini tekshiring.
• Mustahkam xatolarni qayta ishlash: Yuklamalarni dekodlashda yoki potentsial yo'q sarlavhalarga kirishda keng qamrovli try-except bloklarini joriy qiling. UnicodeDecodeError yoki KeyErrorni osonlik bilan hal qiling.
• Katta ilovalar bilan ishlash: Ilova hajmlariga e'tibor bering, ham yaratishda (pochta serveri cheklovlaridan oshib ketmaslik uchun), ham tahlil qilishda (haddan tashqari xotira yoki disk maydoni sarfini oldini olish uchun). Agar tizimingiz qo'llab-quvvatlasa, katta ilovalarni oqim (streaming) usulida qayta ishlashni ko'rib chiqing.
• email.policy dan foydalanish: Muhim ilovalar uchun, elektron pochta standartlariga qat'iy rioya qilishni ta'minlash uchun `email.policy` ni (masalan, `policy.SMTP`) aniq tanlang, bu yetkazib berish va o'zaro muvofiqlikka ta'sir qilishi mumkin.
• Metama'lumotlarni saqlash: Tahlil paytida, qaysi metama'lumotlarni (sarlavhalar, asl chegara satrlari) saqlash muhimligini hal qiling, ayniqsa pochta arxivlash yoki yo'naltirish tizimini qurayotgan bo'lsangiz.

Xulosa

Pythonning email paketi elektron pochta bilan dasturiy ravishda ishlashga muhtoj bo'lgan har bir kishi uchun nihoyatda kuchli va moslashuvchan kutubxonadir. MIME xabarlarini yaratish va kiruvchi elektron xatlarni ishonchli tahlil qilishni o'zlashtirib, siz murakkab elektron pochta avtomatlashtirish tizimlarini yaratish, elektron pochta klientlarini qurish, elektron pochta ma'lumotlarini tahlil qilish va elektron pochta funksiyalarini deyarli har qanday ilovaga integratsiya qilish qobiliyatiga ega bo'lasiz.

Paket MIMEning asosiy murakkabliklarini puxta o'ylangan holda boshqaradi, bu esa dasturchilarga o'zlarining elektron pochta aloqalarining mazmuni va mantig'iga e'tibor qaratish imkonini beradi. Global auditoriyaga shaxsiylashtirilgan axborotnomalarni yuborayotgan bo'lsangiz yoki avtomatlashtirilgan tizim hisobotlaridan muhim ma'lumotlarni ajratib olayotgan bo'lsangiz ham, email paketini chuqur tushunish ishonchli, o'zaro muvofiq va global miqyosda ishlaydigan elektron pochta yechimlarini yaratishda bebaho bo'ladi.